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Preface - Brief History and Background 


• XTCE 1.0 first published in 2005 

- OMG's Space Domain Task Force (SDTF) - from 2000 

- { ESA, Boeing Comm. Sat., US AF SMC Det 12/VO - Lockheed Martin } original submitters 
+ NASA/GSFC + Harris Corp. 

• CCSDS Published XTCE 1.1 in Oct 2007 as Blue Book 

- XTCE 1.1 revved in conjunction w/CCSDS agency review 

- XTCE 1.1 Green Book (overview) 2007 

- XTCE 1.1 Magenta Books (user guide/ccsds tailoring - out or draft available) 

- XTCE 1.2 - early drafts to clean up some minor bugs... nothing official yet 

• Goal 

- Provide industry w/standard mechanism for describing telemetry and command 
streams (principally from satellites) 

- Lower cost and increase validation over traditional formats 

• XML widely adopted by industry, many technologies available to leverage 

• XML Schema provides some validation 

- Support exchange or native format 
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Preface - Applicability 



• XTCE is designed to describe bit-streams 

- "bit-packed" - no markers, or metadata, non-self describing 

- Typical of telemetry & command in historic space domain 

- Focus is really at the packet or minor frame level 

• Although there is an element for "Stream" descriptions 

- For example, CCSDS packet descriptions, telemetry and command 

• Probably not the CCSDS frame, RS, CADU, etc..., (FEP) - outside of XTCE 

• Use for Exchange, but... 

- Best in a team scenario where all parties are implementing the same format 

- As this separation increases, 100% exchange is less and less achievable 

• Or native format 

- Nothing precludes using XTCE as the native format for toolset that supports to 
decommutate telemetry or build commands 
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• XML 


<Tag> 

<SubTag attribute -' Data 1 "/> <!- comment: tags are also called elements —> 
Data 2 
</Tag> 

• XML Schema 

- Rules for defining your tags and attributes 


- And their data-types, value ranges 

- And their cardinality (count) 

- Validate XML files with your XML Schema using an XML parser 
• XTCE is an XML Schema 

- Create specific XTCE XML files describing your telemetry and command format 

- Validate XTCE XML files with the XTCE Schema 

• XTCE XML files - aka "Instance documents" 

- Exchange: give your XTCE file to your friend 


Order, optional or not, choice of 
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Preface - Quick UML 


Generalize 
“IS A” 
“Subclass” 
“Derive”, “Extend”, 
“Restrict/Narrow” 



One 

{Constraint} 

Two 

0-* 




Association 
"HAS A" 


Note: various styles of association are present in UML 
-Aggregation 
- Composition 

- Bidirectional/unidirectional 


Child Inherits properties from Parent 
-- OR overrides properties explicit in the 
Parent 


One “asks” Two to do something 


XTCE has an Object Oriented Model in its Container and Command areas 
Basic UML Diagrams to describe the relationships present in the examples 
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Chapter 1 - XTCE Overview 


<SpaceSystem> 

<TelemetryMetaData/> 

<CommandMetaData/> 

<SpaceSystem/> 

</SpaceSystem> 
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Chapter 1 - XTCE Overview (Cont'd) 



<SpaceSystem> 

<TelemetryMetaData/> 

<CommandMetaData/> 

<SpaceSystem/> 

</SpaceSystem> 




Space System 

- Element: <SpaceSystem> 

• one or many in a tree configuration 

- Optional child elements for things like date, authors, etc... 
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Chapter 1 - XTCE SpaceSystem Tree(s) 
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Chapter 1 - XTCE Overview (Cont'd) 



<SpaceSystem> 

<TelemetryMetaData> 

<ParameterSet/> 

< Pa ra m eterT y peSet > 

</TelemetryMetaData> 

<CommandMetaData/> 

<SpaceSystem/> 

</SpaceSystem> 

• Telemetry Items 

- Elements: <Parameter> & <ParameterTypes> "Parameters" 

- Link Data Type of link info (e.g. integer count) 

• Integer, Float, String, Binary 

• Size in Bits, format (IEEE784, twos complement, etc...), signed/unsigned, bit order, byte order, etc... 

- Host Data Type after conversion to host (e.g. float) 

• Enumerated, String, Binary, Integer, Float, Boolean, Time (absolute/relative), array, aggregate ("struct") 

• Size in bits, initial value, signed/unsigned, etc... 

- Range of Content (integer/float) 

- Calibration (varies by ParameterType) 

- Alarms (also varies by ParameterType) 
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Chapter 1 - SpaceSystem Diagram in XTCE 


<xtce:SpaceSystem name= “My Root” > 

<xtce: TelemetryMetaData/> < 

<xtce:CommandMetaData/> 

<xtce:SpaceSystem name=“MySubSys1”/> 

<xtce:SpaceSystem name=“MySubSys2”/> <- 

<xtce: SpaceSystem name= “MySubSys3 ”> 

<xtce: TetemetryMetaData/> 
<xtce:CommandMetaData/> 

<xtce:SpaceSystem name=“MySubSubSys3. 1”/> 
<xtce:SpaceSystem> 

<xtce:SpaceSystem> 


Common Tlm/Cmd 


Tlm/Cmd for this sub-sys 


Note: child elements of SpaceSystem not shown for purposes of illustration 
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Chapter 1 - XTCE Overview (Cont'd) 



<TelemetrvMetaData> 

<ParameterSet/> 

<ParameterTypeSet/> 

<ContainerSet> 

<SequenceContainer/> 

</ContainerSet> 

</T elemetryMetaData 

• Telemetry Packaging (packets, minor frames) 

- Element: <SequenceContainer> "Containers" 

- Specify Sequence of parameters or other containers in the packet/minor frame 

• Optional include condition, addressing and repeat (super-sampling) 

• Size in bits - optional - default: calculated from entries 

• Optional rate of update, bit/byte order, etc... 

- Optionally EXTEND another container 

• Element: <BaseContainer> and its child <RestrictionCriteria> (constraint) 

• Provide name of other container and constraint expression 

• Child inherits certain properties from parent, mainly its entries 

• Use to provide identifying information of packet/minor frame 
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Chapter 1 - XTCE Overview (Cont'd) 


• Commanding: element <CommandMetaData> 

- Command Parameter and ParameterType 

• Same construction as on telemetry side - ignore alarms 

• Interpreted as host to uplink 

• System supplied information (checksum, etc...) 

- Command Description 

• Element: <MetaCommand> 

• Describe command, its arguments, local packaging information verifiers and other related items 

• Child — Local Packaging is called: <CommandContainer> (command packet) 

• Child Element: <Argument> links to <ArgumentType> 

• Similar underlying construction Parameter/ParameterType 

- Interpreted the same way Command Parameters are interepreted 

• Meant to be used for user supplied information (command argument) 

- Command Container <CommandContainerSet> 

• Element: <CommandContainer> 

• Similar to SequenceContainer, refer to it in MetaCommand/CommandContainer 

• Group common command parameters reused by more than one command 


<SpaceSystem> 

<TelemetryMetaData/> 

< Command Meta Data > 

<ParameterSet/> 

< ParameterTypeSet/ > 
<MetaCommandSet/> 
<CommandContainerSet/> 
</CommandMetaData> 
<SpaceSystem/> 
</SpaceSystem> 
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Chapter 1 - XTCE Overview (Cont'd) 


<TelemetryMetaData> 

<ParameterTypeSet> 

<lntegerParameterType name=“MyType”/> 
</ParameterTypeSet> 

<ParameterSet> 

<Parameter name=“MyParam” parameterType=“MyType”/> 
</ParameterSet> 

</T elemetry MetaData> 


• NameReferences 

- Many major XTCE elements refer to other areas in an XML file 

- XTCE's version of "pointers" are called NameReferences 

• Just strings with a specific format: "String Pointers" 

- Several Variations 

• Plain & Unix-like path: /SpaceSystemNamel/SpaceSystemName2/.../itemName 

- Absolute, relative, and the "no path" (plain) version 

• Note: plain is not global; refers to local SpaceSystem first or up "the SpaceSystem tree 
relative to that location 

- Outside of XML parsing unfortunately - you must implement 

- Careful implementation required - used in many XTCE areas: 

• Parameter & ParameterType, Argument and ArgumentType 

• All Containers, Metacommand, all Comparisons... others? 
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Chapter 2 - Describing Telemetry Items 


<SpaceSystem> 

<TelemetryMetaData> 

< ParameterTypeSet/ > 

< ParameterSet> 

</TelemetryMetaData> 

< Com ma nd Meta Data / > 
<SpaceSystem/> 
</SpaceSystem> 
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Chapter 2 - Describing Telemetry Items 


< Pa ra meterT y peSet > 

< Str i ng Pa ra mete rTy pe/ > 
<EnumeratedParameterType/> 

< Bi na ry Pa ra meterT y pe/ > 
<IntegerParameterType/> 
<FloatParameterType/> 
<BooleanParameterType/> 
<AbsoluteTimeParameterType/> 
<RelativeTimeParameterType/> 
<ArrayParameterType/> 
<AggregateParameterType/> 

</ParameterTypeSet> 


Host Side Data Type Link Info 

String, 

Enumerated, 

Binary, 

Integer 

Float 

Boolean 

AbsoluteTime 

RelativeTime 

Array 

Aggregrate (groups other Parameters) 
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Lnapter Z — Pattern to (most) ParameterTypes 



< Str i ng Pa ra mete rT y pe > 

< Stri ng Data Encod i ng/ > 

<IntegerDataEncoding/> 

<FloatDataEncoding/> 

<BinaryDataEncoding/> 

<Alarms/> 

</StringParameterType> 


Link Side Data Encoding: how is the 
information described on the link? 


Choice of One 
or 

None 


-Choice of one (or none) 

-Not all ParameterType & DataEncoding 
make sense necessarily 
-Alarms and some additional specifics 
vary by ParameterType 
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Chapter 2 - ParameterTypes Semantics 


• ParameterTypes have the following relationship between information on the 
"link" and ground 

- and has specific elements and attributes to describe these items 


Encoded Link 

r — 

VaiidRange l 

Data Type 

i Check \ 


Calibration 

I SJep_ _ j 


! v 

Host 

Aiarm ■ 

i / 

Data Type 

! Check ! 


DotoEncodinq 

-StringDataEncoding 
-IntegerDataEncoding 
-FloatDataEncoding 
-Binary Data Encoding 


ParameterType 

-String 

-Float 

-Integer 

-Enumeration 

-Binary 

-Boolean 

-Time 

- Array , Aggregate 


Missions will likely wish to restrict these various elements and attributes for various ParameterType... 
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Chapter 2 - DataEncodings 



• Four options, various details: 


- StringDataEncoding 

• UTF8 or UTF16 encoded Unicode (UTF-16 big endian) 

• Bit size, various ways 

- IntegerDataEncoding 

• Unsigned or TwosComplement (spelled "Compliment" in XTCE!) 

• Bit size 

• bit/byte order 

• Various calibrators such as Linear Calibrator or Polynomial Calibrator optional 

- FloatDataEncoding 

• IEEE-745, MIL1750A 

• Bit size 

• bit/byte order 

• Various calibrators such as Linear Calibrator or Polynomial Calibrator optional 

- BinaryDataEncoding 

• Bit size 

• bit/byte order 

• No cals... 


Some additional details left out 
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Chapter 2 - DataEncoding - Examples 


Unsigned int, 32 bits 

<xtce:IntegerDataEncoding sizeInBits="32"/> 

Two Complement, 8 bits 

<xtce:IntegerDataEncoding encoding ="twosCompliment"/> 

Float, 32-bit, IEEE-754 

<xtce : FloatDataEncod i ng/ > 


Unicode String, UTF-16 


Note: defaults are not shown, the parser 
should provide it, helps keep the file shorter 


< xtce : Stri ng Data Encod i ng encod i ng = " UTF- 1 6" > 

<!- Example: Length in bits is 11 characters --> 
<!-- 16-bits per character --> 

<xtce:SizeInBits> 

< xtce: Fixed > 

<xtce : Fixed Va I ue > 1 76 </xtce : Fixed Val ue > 
</xtce: Fixed > 

</xtce:SizeInBits> 

</xtce:StringDataEncoding> 
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Chapter 2 “ Telemetry ParameterTypes - Reference Diagra m 


Encoded Link 

r j 

VaiidRange l 

Data Type 

i Check 


Calibration 

I SJep_ _ j 


! v 

Host 

Aiarm ■ 

i / 

Data Type 

! Check ! 


DataEncodinp 

-StringDataEncoding 
-IntegerDataEncoding 
-FloatDataEncoding 
-Binary Data Encoding 


ParameterType 

-String 

-Float 

-Integer 

-Enumeration 

-Binary 

-Boolean 

-Time 

- Array , Aggregate 
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Chapter 2 - ValidRange Check 


• ValidRange Check 

- IntegerParameterType and FloatParameterType only 


<xtce: ValidRange minlnclusive="0" maxlnclusive="100"/> 


Ignore for Telemetry side: 

-lntegerParameterType/@validRangeAppliesToCalibrated=(true | false) 
-FloatParameterTyype/@validRangeAppliesToCalibrated=(true | false ) 


www.nasa.gov 


XTCE Tutorial, Torrance, California, March 23, 2009 


22 


National Aeronautics and Space Administration 


Chapter 2 “ Telemetry ParameterTypes - Reference Diagra m 


Encoded Link 

r — 

VaiidRange l 

Data Type 

i Check \ 


Calibration 

_SJep_ _ j 


! ^ 

Host 

Aiarm ■ 

r / 

Data Type 

! Check : 


DataEncodinp 

-StringDataEncoding 
-IntegerDataEncoding 
-FloatDataEncoding 
-Binary Data Encoding 


ParameterType 

-String 

-Float 

-Integer 

-Enumeration 

-Binary 

-Boolean 

-Time 

-Array, Aggregate 
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Chapter 2 - Calibrators 



• Calibrators are defined in the DataEncoding area 

• A DefaultCalibrator 

- Just one 

• Or ContextCalibrators 

- Many 

- Conditional "Contexts", user defined 

• We'll look at two common types 

- polynomial (PolynomialCalibrator) 

- line segment (SplineCalibrator) 
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Chapter 2 - Linear Calibrator 



<xtce:SplineCalibrator> 

< .'-Forward (regular) calibration --> 
<xtce:SpimePoint raw="1 " caHbrated="10'/> 
<xtce:SpimePoint raw="2" calibrated="100"/> 
<xtce:SplinePoint raw= "3 " calibrated= "500 "/> 
</xtce:SplineCalibrator> 


There's an optional @order attribute in SplinePoint - this is a typo, ignore 
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Chapter 2 - Polynomial Calibrator 


The equation for the calibration is: y = -0. 0048x 2 + 1.4091x- 48.886 


<xtce:PolynomialCalibrator> 

< .'-Forward (regular) calibration --> 

<xtce: Term exponent= "0 " coefficient= "-48. 886"/> 
<xtce: Term exponent= "1 " coefficient= "1. 409 1 "/> 
<xtce: Term exponent= "2" coefficient= ”-0. 0048 "/> 
</xtce:PolynomialCalibrator> 


48.886 
1.409 lx 
0.0048x 2 
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Chapter 2 “ Telemetry ParameterTypes - Reference Diagra m 


Encoded Link 

r — 

VaiidRange l 

Data Type 

i Check \ 


Calibration 

I SJep_ _ j 


! v 

Host 

\! 

i / 

Data Type 

A 


Alarm 

Check 


DataEncodinp 

-StringDataEncoding 
-IntegerDataEncoding 
-FloatDataEncoding 
-Binary Data Encoding 


ParameterType: 

String, 

Enumerated, 

Binary (catch all), 

Integer 

Float 

Boolean 

AbsoluteTime 

RelativeTime 

Array 

Aggregrate (groups of other Parameters) 
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Chapter 2 - 


Accepted ParameterType/DataEncoding 
Combinations 



StringParameterType + StringDataEncoding 

• Unicode String encoded as either UTF-8 or UTF-16 


BooleanParameterType + IntegerDataEncoding 

• True/False 


EnumeratedParameterType + IntegerDataEncoding 

• LABEL, VALUE pairs 


BinaryParameterType + BinaryDataEncoding 

• Blob data 


IntegerParameterType + IntegerDataEncoding 

• Integers of various well known formats 

•(one/twos complement, etc...) 

• Calibrated/uncalibrated 


FloatParameterType + FloatDataEncoding 

• Floats of well known formats (IEEE/MIL1750A) 

• Calibrated/uncalibrated 


FloatParameterType + IntegerDataEncoding 

• Integer counts to units conversion 

• Calibrated 


AbsoluteTimeParameterType + IntegerDataEncoding 

• Time 

• Same for RelativeTimeParameterType 

• Variation for ASCII format 


Aggregate and Array ParameterType 

• N/A 


Integer/FloatParameterType + BinaryDataEncoding 

• Float/Integer format not in XTCEs default list 

• Add Ancillary to help document 


Others? 

• not accepted but not illegal! 
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Chapter 2 “ Telemetry ParameterTypes - Reference Diagra m 


Encoded Link 

r — 

VaiidRange l 

Data Type 

i Check \ 


Calibration 

I SJep_ _ j 


! v 

Host 

Aiarm ■ 

i / 

Data Type 

! Check 


DataEncodinp 

-StringDataEncoding 
-IntegerDataEncoding 
-FloatDataEncoding 
-Binary Data Encoding 


ParameterType 

-String 

-Float 

-Integer 

-Enumeration 

-Binary 

-Boolean 

-Time 

- Array , Aggregate 
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Chapter 2 - Alarms 


• DefaultAlarm and ContextAlarms also 

• A variety of limit checks are available in XTCE and tuned 
to their ParameterType somewhat: 

- AlarmConditions: check a condition 

- StaticAlarmRanges: compare values against set of ranges 

- ChangeAlarms: Rate or Delta 

- Slight variations for String & Enum alarms 


XTCE Alarm Ranges 
(optional) 

Normal - Inside Least Severe 
Range 

Watch Range 

WarningRange 

CriticalRange 

SevereRange 


More severe ranges clip lower ranges 
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Chapter 2 - StaticAlarmRange Example 



<xtce:StaticAlarmRanges> 

<xtce : Watch Range minlnclusive="-2000.0" maxlnclusive="5000. 0"/> 
<xtce:Se vereRange minlnclusive = "-5000. 0 " maxlnclusiv e= "6000. 0 "/> 
</xtce:StaticAlarmRanges> 

Real Ranges: 

-Green: -2000 .0 > * < 5000.0 - implied 
-Watch: *<= -2000.0 or * >= 5000.0 
-Severe: *<= -5000.0 or *>= 6000.0 



Note: Color designation is not part of XTCE, user dependent 
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Chapter 2 - AlarmConditions 




• Set up conditions for up to five levels 

- The alarm "returns" the highest level triggered 

- Simple single conditions, multiple conditions, boolean expressions, custom algorithms 


<xtce:AlarmConditions> 

< > 

<xtce:Comparison parameterRef-'pressureValue" value="100" comparisonOperator="&gt;"/> 
</xtce:WarningAlarm> 

<xtce:CriticalAlarm> 

<xtce:Comparison parameterRef-'pressureValve" value="150" comparisonOperator="&gt;"/> 
</xtce:CriticalAlarm> 

<xtce:SevereAlarm> 

<xtce:Comparison parameterRef="pressureValve" value="175" comparisonOperator="&gt;"/> 
</xt ce : S e ve re A I a rm > 

</xtce:AlarmConditions> 
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Chapter 2 - ChangeRateAlarms 


• Similar to the others in terms of ranges but two choices in 
one element... 


Rate of Change 


Delta Change 


Attribute 

Value 

Attribute 

Value 

@changeType 

changePerSecond 

@changeType 

changePerSample 

@changeBasis 

absoluteChange | 

percentageChange 

@changeBasis 

absoluteChange | 

percentageChange 

@spanOfInterestInSamples 

ignore 

(cpspanOflnterestlnSamples 

1 or more 

@spanOfInterestInSeconds 

1 or more 

(ffispaceOflnterestlnSeconds 

ignore 
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Chapter 2 - ParameterType Examples 


IntegerParameterType 


<xtce:tntegerParameterType signed-'false" name="CUIA Type"> 

<xtce:UnitSet/> 

<xtce:lntegerDataEncoding sizelnBits="32"/> 

<xtce:DefaultAlarm> 

<xtce:StaticAlarmRanges> 

<xtce: WatchRange min/nc/usive= ”-2000. 0 " maxlnclusive= ”5000. 0 "/> 
<xtce:WarningRange min/nc/usive="-5000. 0" maxlnclusive="6000. 0"/ 
</xtce:StaticAlarmRanges> 

</xtce:DefaultAlarm> 

</xtce:!ntegerParameterType> 
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Chapter 2 - ParameterType Examples 


FloatParameterType 


<xtce:FloatParameterType sizelnBits="64" name=“LightType"> 

<xtce:UnitSet> 

<xtce:Unit description="Bq ">Becquerel</xtce:Unit> 
</xtce:UnitSet> 

<xtce:lntegerDataEncoding sizelnBits="16" encoding="twosCompliment"> 
<xtce:DefaultCalibrator> 

<xtce:SplineCalibrator> 

<xtce:SplinePoint ra w= "-32768. 0 " calibrated = "0. 0 "/> 
<xtce:SplinePoint ra w= "0. 0 " cal ib rated = "5. 0 "/> 
<xtce:SplinePoint ra w- "32767. 0 " cal i bra ted = "20. 0 "/> 
</xtce:Sp/ine Calibrator 
</xtce:DefaultCalibrator> 

</xtce:lntegerDataEncoding> 

</xtce:F!oatParameterType> 
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Chapter 2 -TelemetryMetaData - Context 




CMD 
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Chapter 2 - Parameter: "Points" to a ParameterType. 


• Parameter 

• Holds a name - in your name format "BAV10089-B" 

• And a "string pointer" - a Ref - to a ParameterType 

• And an optional "ParameterProperties/@dataSource" attribute 

• Telemetered (default - cmd side ignore) 

• Derived, local, etc... 

• ParameterTypes may be shared by different Parameters... 


<xtce:ParameterTypeSet> 

<xtce: IntegerParameterT ype name=“MyParameterT ype”/> 
</xtce:ParameterTypeSet> V 

<xtce:ParameterSet> ^ 

<xtce: Parameter name=“BAV10089-B” parameterTypeRef=“MyParameterType7> 
</xtce:ParameterSet> 
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Chapter 3 -TelemetryMetaData - Context 




CMD 
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Chapter 3 - XTCE Containers 



• Use to represent "memory layout" of Parameters 

- EntryList specifies content and layout: 

• Default: items are "packed" back to back 

• Width taken from ParameterType (look up Parameter, then its Type) 

- Element: <SequenceContainer> 

• Very general, may refer to other SeqContainers, Parameters 


<SequenceContainer name= "MyDataB!ock"> 
<EntryList> 

<ParameterRefEntry parameterRef^ "PI '/> 
<ParameterRefEntry parameterRef- "P2"/> 
<ParameterRefEntry parameterRef = "P3"/> 
</EntryList> 

</SequenceContainer> 
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Chapter 3 - Entry Addressing 


• Location of the entry is an integer value referenced from: 

- The end of the previous entry to the start of This Entry (default) 

- The start of the container to the start of This Entry fcontainerStarf) 

- The end of the container to the end of This Entry (containerEnd) 

- The start of the next entry to the end? of this entry (nextEntrv) 


containerEnd 
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Chapter 3 - 


Telemetry Packet Description 
(“Packaging”) - The Simple 



• Use Containers to describe groups of Parameters 

- Headers 

- Packet Bodies 

- Shared groupings of parameters 

• EntryList: ParameterRefs, ContainerRefs (others not covered but similar in concept) 
<xtce:ParameterTypeSet> 

<xtce: IntegerParameterT ype name- ‘MyParameterT ype”/> 
</xtce:ParameterTypeSet> 

<xtce:ParameterSet> 

<xtce: Parameter name=“MyParameter” parameterTypeRef=“MyParameterType7> 
</xtce : P a ra m ete rS et> 

<xtce:SequenceContainer name=“MyPacket”> 

<xtce:EntryList> 

<xtce:ParameterRefEntry parameterRef=“MyParameter’7> 

<xtce:EntryList> 

</xtce:SequenceContainer> 
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Chapter 3 - Containers - EntryList Options 

• The EntryList defines the Parameters in the Container (parameterRefEntry) 

- Each entry has implied back-to-back addressing info 

• Various options like absolute addressing can be given 

- The bit-width of each is taken from its ParameterType/DataEncoding size 

- These two together define layout 

<xtce: Entry List> 

<xtce: ParameterRefEntry parameterRef=“Parameter1"> < 

<xtce:LocationlnContainerlnBits referenceLocation- 'containerStart"> < 

<xtce:FixedValue>0<xtce:FixedValue> < 

</xtce:LocationlnContainerlnBits> 

</xtce:ParameterRefEntry> 

<xtce: ParameterRefEntry parameterRef =“Parameter2"> 

<xtce:LocationlnContainerlnBits referenceLocation- 'containerStart"> 
<xtce:FixedValue>64<xtce:FixedValue> 

</xtce:LocationlnContainerlnBits> 

</xtce:ParameterRefEntry> 

</xtce:EntryList> 
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Chapter 3 - Container Inheritance 



• Use Container Inheritance to fully describe a packet or minor frame 

• Containers may EXTEND another Container (aka "Container inheritance") 

- BaseContainer child element 

• Supply the Parent or "Super" Container Ref 

• Supply "Constraints" - a set of conditions that must be true for this description 


- Conditions are usually Parameters in the Parent Container 

- The condition Parameters are probably IDENTIFYING areas of a packet/minor frame: 

» Ex. CCSDS Land: 

» APID 

» Packet Length 

» SCID, VCID (note: these are not in packet header!) 


• Conceptually somewhat similar to Class Inheritance 

- Extending Container gets some things from Parent 

• Principally the EntryList 

- Or it may override some things 

• A few of the other elements in Container (Size) 

• Simplified UML Class Diagrams useful to show relationship between 
containers 
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Chapter 3 - Basic Telemetry Inheritance 


Properties: 
-Abstract 
-Header Fields 
-APID, Length 

Identifying Areas: 
- APID. Length 
- SC/D. VC/D 

Properties: 

-Packet parameters 


MyPacket 


XTCE Construction 


Layout 


MyFormat 

Container 

addresses 

7 

{Constraints 

-SCID=154, VCID=3 
-APID=100, Length=300} 

MyPacket 

Container 

addresses 


SCID=154 

VCID=3 




MyFormat 
Entries 


APID=100 


LEN=300 


MyPacket 

Entries 


addresses 


Conceptually 
entries of both 
form a whole 


v 


The constraints allow one to match incoming bits with 
these descriptions - whether literally or conceptually 
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Chapter 3 -Telemetry Packet Description 

MyPacket 



The XTCE constructions: 


<xtce:SequenceContainer name=“MyFormat” abstract=“true”> 
<xtce: Entry L ist> 

<xtce:ParameterEntryRef parameterRef=“APID> 
<xtce:ParameterEntryRef parameterRef= “L EN> 
</xtce:EntryL ist> 

</xtce:SequenceContainer> 

<xtce:SequenceContainer name= “MyPacket> 

<xtce: Entry L ist> 

<xtce:ParameterEntryRef parameterRef= “P 1 ”> 
<xtce:ParameterEntryRef parameterRef= ‘P2 ”> 

<xtce : ParameterE ntry Ref parameter Ref = ‘P3 ”> 

</xtce:EntryL ist> 

<xtce:BaseContainer containerRef=“MyFormatPacket”> 
<xtce:RestrictionCriteria> 

<xtce:ComparisonL ist> 

<xtce:Comparison parameterRef=“APtD" value-' 100”/> 
<xtce:Comparison parameterRef=“LEN" value=“300”/> 
<xtce:Comparison parameterRef=“SCID" value=“154”/> 
<xtce:Comparison parameterRef-'VCID" value=“3”/> 
</xtce:RestrictionCriteria> 

</xtce:BaseContainer> 

</xtce:SequenceContainer> 


MyFormat IS A SequenceContainer 


MyPacket IS A MyFormat 


<ConceptualEntries> 

<APID/> 

<LEN/> 

<P1/> 

<P2/> 

<P3/> 

<When> 

<APID==100/> 

<LEN==300/> 

<SCID==154/> 

<VCID==3/> 

</When> 

</ConceptualEntries> 


Identifying Constraints 


NOTE: SCID and VOID are Session 
Variables, supplied by the System 
in this construction - NOT SHOWN 
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Chapter 4 - CommandMetaData 



Child Element of SpaceSystem 
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Chapter 4 - CommandMetaData 



Command Descriptions 


• XTCE CommandMetaData shares many elements with 
TelemetryMetaData 

- ParameterSet and ParameterTypeSet are exactly the same 

- ArgumentTypeSet is similar to ParameterTypeSet 

- CommandContainerSet is the same as ContainerSet 

• This section then will focus on the differences between the 
telemetry and command side 

- Most of what has just been presented for telemetry is the same for 
commanding... but not all of it 

- Some items which of the same construction have a slightly different 


meaning 
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Chapter 4 - Major CommandMetaData Elements 



<xtce:SpaceSystem> 

<xtce: TelemetryMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ContainerSet/> 

</xtce: TelemetryMetaData> 
<xtce:CommandMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ArgumentTypeSet/> 
<xtce:MetaCommandSet/> 
<xtce:CommandContainerSet/> 
</xtce:CommandMetaData> 
</xtce:SpaceSystem> 
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Command 

Chapter 4 - ParameterTypes and ArgumentTypes 



• Command ParameterTypes are the same construction as Telemetry ParameterTypes 

• ArgumentTypes are similar construction to Telemetry ParmeterType as well 

• However the exact relationship of sub-elements is different, as follows: 

- Order is interpreted differently than telemetry - calibrators are "reverse" (aka raw to units) 

- No alarms under ArgumentTypes, they exist under Command ParameterTypes... 

• But probably shouldn't 

- Valid Range may be in one of two places depending on @validRangeAppliesToCalibrated value 


Host 

Data Type 


Valid Range i — Calibration , — > Encoded Link 

L - Check#! _\ J SJe_p_ _ J Data Type 


>! VaHd Range . 
L -Qpack#2_ \ 


PorameterType 


DataEncodinp 

-StringDataEncoding 
-IntegerDataEncoding 
- FloatDataEncoding 
-Binary Data Encoding 


-String 

-Float 

-Integer 


-Enumeration 


-Binary 

-Time 


-Array/Aggregate 


Generally the various accepted combinations Type/DataEncoding are the same for Telemetry ParameterTypes 
VaiidRange is slightly different, and no alarms should be specified 
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Chapter 4 - 


Command MetaData 
Parameters and Arguments 



<xtce:SpaceSystem> 

<xtce: TelemetryMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ContainerSet/> 

</xtce: TelemetryMetaData> 
<xtce:CommandMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ArgumentTypeSet/> 
<xtce:MetaCommandSet> 
<xtce:MetaCommand> 
<xtce:ArgumentList/> 
</xtce:MetaCommand> 
</xtce:MetaCommandSet> 
<xtce:CommandContainerSet/> 
</xtce:CommandMetaData> 
</xtce:SpaceSystem> 
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Chapter 4 - 


Command Parameters and Argument 
Differences 




• In XTCE Parameters are something set by the System (e.g. 
a Checksum) 

• While an Argument is set the by user 

- Subsystem destination for example, cmd specific 

• Arguments are defined local to a Command 

- They are associated with the Metacommand Element 

• Other than this the two are very similar 

- Arguments Ref ArgumentTypes, Parameters Ref ParameterTypes 

- And they are constructed by closely related Schema Types 

• So they have virtually the same elements and attributes within 
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Chapter 4 - Context Diagram 


Host 

r — 

VatidRange i— 

— >■ Calibration \ — > 

Encoded Link 

Data Type 

i Check #1 ! 

I Step i 

Data Type 


ParameterType 

-String 

-Float 

-Integer 

-Enumeration 

-Binary 

-Time 

-Array/Aggregate 


DataEncodinq 

-StringDataEncoding 
-IntegerDataEncoding 
-FloatDataEncoding 
-Binary Data Encoding 


\ VatidRange i 
i_ _Chec_k#2_ \ 
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Chapter 4 - ValidRange in Commanding 



• ValidRange in Commanding 

- Unlike Telemetry -- can be set to apply BEFORE the command or 
AFTER the command (but not both) 

• BEFORE 

- leave attribute validRangeAppliesToCalibrated true (default) 

• AFTER 

- set attribute validRangeAppliesToCalibrated to false 
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Chapter 4 


Command MetaData 
Describing Commands 



<xtce:SpaceSystem> 

<xtce: TelemetryMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ContainerSet/> 

</xtce: TelemetryMetaData> 
<xtce:CommandMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ArgumentTypeSet/> 
<xtce:MetaCommandSet> 
<xtce:MetaCommand> 
<xtce:ArgumentList/> 
<xtce:CommandContainer> 
</xtce:MetaCommand> 
</xtce:MetaCommandSet> 
<xtce:CommandContainerSet/> 
</xtce:CommandMetaData> 
</xtce:SpaceSystem> 


MetaCommand/CommandContainer is a LOCAL CommandContainer for Commands 
• Build Command Packets here! 
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Describing Commands and Command Packets 
Chapter 4 - w/the Metacommand Element 




• Use the Metacommand element to describe Commands 

- Supply Command Arguments 

- A local Container for their Packets 

- Add Verifiers, Interlock, Priority, various constraints, side effects 

- And use Metacommand Inheritance to build up the Command 


• Use the local MetaCommand/CommandContainer to build its 
Packet (or Minor Frame) 


- Reference Command Parameters 

- Reference Command Arguments 

- And it may Reference other CommandContainers (CommandContainerSet) 

- Also has Inheritance Mechanism similar to Container Inheritance 


• Similar to Container Inheritance 
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Chapter 4 - Command Inheritance 


• A Metacommand may EXTEND another 

- One Command may EXTEND another 

- BaseMetaCommand 

• Give the Ref of the Metacommand being extended 

• The extending command can add arguments 

- It gets any Parent arguments and adds its own 

• Or it can set arguments in the Parent's Command 

- MetaCommand/BaseMetaCommand/ArgumentAssigmentList 


Example 
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Chapter 4 — Command Inheritance in XTCE 



<xtce:MetaCommand name=“PowerCommand abstract="true"> 

<xtce:ArgumentList> 

<xtce:Argument name=“SubSystemName" argumentTypeRef='‘SubSysEnumType"/> 

<xtce:Argument name=“DeviceName" argumentTypeRef=“DeviceEnumType"/> 

<xtce:Argument name=“State" argumentTypeRef=“StateEnumType"/> 

</xtce:ArgumentList> 

<xtce:CommandContainer/> 

</xtce:MetaCommand> 

<xtce:MetaCommand name=“HeaterOn"> 

<xtce:ArgumentList> 

<Argument name=“TemperatureCutoff" argumentTypeRef=‘‘FloatType"/> 

</xtce:ArgumentList> 

<xtce:BaseMetaCommand metaCommandRef=“PowerCommand”> 

<xtce:ArgumentAssignmentList> 

<xtce:ArgumentAssignment argumentName="SubSystemName" argumentValue=“ThermalContror7> 
<xtce:ArgumentAssignment argumentName="DeviceName" argumentValue=“Heater1"/> 
<xtce:ArgumentAssignment argumentName="State" argumentValue=“ON"/> 
</xtce:ArgumentAssignmentList> 

</xtce:BaseMetaCommand> 

<xtce:CommandContainer/> 

</xtce:MetaCommand> 

<xtce:MetaCommand name=“HeaterOff"> 

<xtce:ArgumentList> 

<Argument name-‘Override" argumentTypeRef=“BooleanType"/> 

</xtce:ArgumentList> 

<xtce:BaseMetaCommand metaCommandRef=“PowerCommand7> 

<xtce:ArgumentAssignmentList> 

<xtce:ArgumentAssignment argumentName="SubSystemName" argumentValue=“ThermalControl"/> 
<xtce:ArgumentAssignment argumentName="DeviceName" argumentValue=“Heater1"/> 
<xtce:ArgumentAssignment argumentName="State" argumentValue=“OFF"/> 
</xtce:ArgumentAssignmentList> 

</xtce:BaseMetaCommand> 

<xtce:CommandContainer/> 

</xtce:MetaCommand> 
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Chapter 4 - CommandContainer 



• Metacommand has a local CommandContainer 

- MetaCommand/CommandContainer 

- It's similar to the other Containers but DIFFERENT 

• It has a FixedValueEntry to hard code a value 

• It has an ArgumentRef Entry for Arguments 

• It has a BaseContainer but its RestrictionCriteria is optional 

• It has no abstract attribute either! 

• Use it to build the Packet or Minor Frame associated with the 
Metacommand 

- Any Arguments must be reflected in the EntryList 

- FixedValueEntry might be used to hold opcodes, etc... 

- Any Parameters, that is their values, are supplied by the system 
(conceptually) 

• And put on the link as is specified in the DataEncoding 
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Metacommand’s 
Chapter 4 — CommandContainer in XTCE 



<xtce: Metacommand name=“PowerCommand abstract="true"> 

<xtce:Argumentl_ist> 

<xtce:Argument name=“SubSystemName" argumentTypeRef=“SubSysEnumType"/> 
<xtce:Argument name=“DeviceName" argumentTypeRef=“DeviceEnumType"/> 
<xtce:Argument name=“State" argumentTypeRef=“StateE 
</xtce:Argumentl_ist> 

<xtce:CommandContainer name=“PowerCommandPacket”> 

<xtce:EntryList> 

<xtce:FixedValueEntry binaryValue=“00a0" sizelnBits="167> 

<xtce:ParameterRefEntry parameterRef="CheckSum"/> + 

<xtce:ArgumentRefEntry argumentRef="SubSystemName"/^ 

<xtce:ArgumentRefEntry argumentRef="DeviceName"/> 

<xtce:ArgumentRefEntry argumentRef="State"/> 

</xtce:EntryList> 

</xtce:CommandContainer> 

</xtce:MetaCommand> 





Packet name for example 


“OpCode” for example 


Checksum, calculated 
by the system, inserted here 
before uplink 


The arguments - order 
does not have to match 
ArgumentList but they should 
all be here... 
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Chapter 4 - CommandContainer Inheritance 



• A MetaCommand/CommandContainer may EXTEND another 

- Another MetaCommand/CommandContainerthat is... 

- Similar to Container inheritance in the rest of XTCE 


• RestrictionCriteria is optional 

• Use it when extending another Metacommand 

- Must EXPLICITLY set extending 

MetaCommand/CommandContainer/BaseContainer to the Parent's 
MetaCommand/CommandContainer 

• (easier to visualize than explain) 


- But... 
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Metacommand 

„ CommandContainer Inheritance 

Chapter 4- inX TCE 



<xtce: Metacommand name=“PowerCommand abstract="true"> 

<xtce:Argumentl_ist> 

<xtce:Argument name=“SubSystemName" argumentTypeRef=“SubSysEnumType"/> 
<xtce:Argument name=“DeviceName" argumentTypeRef=“DeviceEnumType"/> 

<xtce:Argument name=“State" argumentTypeRef=“StateEnumType"/> 

</xtce:Argumentl_ist> 

<xtce:CommandContainer name=“PowerCommandPacket”> 

<xtce:EntryList> 

<xtce:FixedValueEntry binaryValue=“00a0" sizelnBits="16"/> <!- opcode --> 

</xtce:EntryList> 

</xtce:CommandContainer> 

</xtce:MetaCommand> 

<xtce: Metacommand name=“HeaterOn"> 

<xtce:ArgumentList> 

<Argument name-TemperatureCutoff' argumentTypeRef=“FloatType"/> 

</xtce:ArgumentList> 

<xtce:BaseMetaCommand metaCommandRef=“PowerCommand"> 

<xtce:ArgumentAssignmentList> 

<xtce:ArgumentAssignment argumentName="SubSystemName" argumentValue=“ThermalControl"/> 
<xtce:ArgumentAssignment argumentName="DeviceName" argumentValue=“Heater1 "/> 
<xtce:ArgumentAssignment argumentName-'State" argumentValue=“ON"/> 
</xtce:ArgumentAssignmentList> 

</xtce:BaseMetaCommand> 

<xtce:CommandContainer name=“HeaterOnPacket”> 

<xtce:EntryList/> 

<xtce:BaseContainercontainerRef="PowerCommandPacket"/> 

</xtce:CommandContainer> 

</xtce:MetaCommand> 


PowerCommand 

Cmd 

“Has A” 


PowerCommand 

Packet 


“Is A” 


HeaterOn Cmd 


“Has A” 

HeaterOnPacket 
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Chapter 4 


Metacommand 

CommandContainer Inheritance 
in XTCE w/RestrictionCriteria 



<xtce: Metacommand name=“PowerCommand abstract="true"> 

<xtce:Argumentl_ist/> <!- args removed for illustrative purposes --> 

<xtce:CommandContainer name=“PowerCommandPacket”> 
<xtce:EntryList> 

<xtce:ParameterRefEntry parameterRef=“OpCode”/> 

<!-- other entries not shown --> 

</xtce:EntryList> 

</xtce:CommandContainer> 

</xtce:MetaCommand> 


System supplies the value 
for OpCode... 


<xtce: Metacommand name=“HeaterOn"> 

<xtce:Argumentl_ist> 

<Argument name=“TemperatureCutoff' argumentTypeRef=“FloatType"/> 

</xtce:ArgumentList> 

<xtce:BaseMetaCommand metaCommandRef=“PowerCommand”> 

<xtce:ArgumentAssignmentList/> <!- arg assignments removed for illustrative purposes ~> 
</xtce:BaseMetaCommand> 

<xtce:CommandContainer name=“HeaterOnPacket”> 

<xtce:EntryList/> <!-- other entries not shown --> 
<xtce:BaseContainercontainerRef="PowerCommandPacket"> 

<xtce:RestrictionCriteria> 

<xtce:Comparison parameterRef=“OpCode” value=“00a0”/> < 

</xtce:RestrictionCriteria> 

</xtce:BaseContainer> 

</xtce:CommandContainer> Simple constraints of the style -parametw = value- could be 

automatically processed to essentially inform the system the values that 
</Xtce.MetaCommand> MUST be supplied in the named parameters. You are encouraged to stick 

with that form for this reason but this is not required. 


But checks the value 
here in this constraint. 
?Opcode == OxaO? 
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Chapter 4 - 


Metacommand and 
MetaCommand/CommandContainer 
Inheritance Summary 


« Metacommand >> 
BasicCommand 


<<CommandContainer>> 

BasicCommandPacket 



{Constraints - optional } 

. 


< < Metacommand > > 
MyCmd 

<<CommandContainer>> 
MyCmd Packet 


A Metacommand may EXTEND another: MyCmd extends BasicCommand above 
Their local CommandContainers extend each other: MyCmdPacket extends BasicCommandPacket 
• Constraints are optional here 
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Chapter 4 - Commanding:Other Items 



• XTCE includes these items in Metacommand: 

- TransmissionConstraint - <TransmissionConstraintList> 

• Check and can be run 

- Implied blockage if constraints fail 

- Significance - <DefaultSignificance>, <ContextSignificanceList> 

• Permission/confirmations 

- Interlock 

• Constraints on the next command 

- Verification - <VerifierSet> 

• Variety of command verification by stages 

- Side Effects - <ParameterToSetList> 

• Side effects after command sent 


- E.g. Command Counter, etc... 


- Suspend Alarms until... <ParameterToSuspendAlarmsSet> 

• Suspend named parameters while cmd takes effect 
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Chapter 4 - CommandContainerSet 



<xtce:SpaceSystem> 

<xtce: TelemetryMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ContainerSet/> 

</xtce: TelemetryMetaData> 
<xtce:CommandMetaData> 
<xtce:ParameterTypeSet/> 
<xtce:ParameterSet/> 
<xtce:ArgumentTypeSet/> 
<xtce:MetaCommandSet> 
<xtce:MetaCommand> 
<xtce:ArgumentList/> 
<xtce:CommandContainer> 
</xtce:MetaCommand> 
</xtce:MetaCommandSet> 
<xtce:CommandContainerSet/> 
</xtce:CommandMetaData> 
</xtce:SpaceSystem> 


CommandContainerSet is NOT the same thing as MetaCommand/CommandContainer 
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Chapter 4 - CommandContainerSet 



• Built using the same XTCE Schema-types as ContainerSet in Telemetry Meta Data... 

• Generally meant to be used as the "pieces/parts" of 
MetaCommand/CommandContainers 

- Chunks of command parameters that repeat or reused by various commands 

• A "has a" relationship 



{Constraints} 


Has A 



For example - perhaps a Command Packet has an optional secondary header 
- Constraint: Secondary Header Flag must be 1 
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Chapter 5 - The Forgotten Elements 



• Lesser used major elements include: 

- TelemetryMetaData/MessageSet 

- StreamSet 

- AlgorithmSet 

- ServiceSet 
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Chapter 5 - MessageSet 


• Deprecated... 

• Essentially an alternative way to build a Packet or Minor 
Frame... 

- A purely "HAS A" relationship to Containers 

- Retained from an earlier version of XTCE 
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Chapter 5 - StreamSet - Streams 



• A set of elements to describe aspects of "bit streams" 

- Possibly could be used for portions of frame description, etc... 

• May be included in containers directly 

- Perhaps a special "sub-stream" in a container 

• CCSDS - not quite enough elements to FULLY describe the "CCSDS 
stack" from the frame-sync to packets 

- Lacks RS encoding info for example 

- Generally focus on packet descriptions and leave the FEP for others 

• Links to a container 

- Probably a "super container" representing the frame... 

• w/derived child container representing specific packets 

• Or links to a service 

- Services are abstractions, perhaps a service has certain streams within it... 
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Chapter 5 - AlgorithmSet 



• Used to describe algorithms used in your tlm/cmd 
processing 

- Many options - from actually including code text, to simply the name 
of a function... 

• Two forms: 

- Custom: functions, methods, procedures... 

- Math: equations using postfix notation... 
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Chapter 5 - Services 



• An abstraction - groups "logically like" Containers 

• For example: 

- Suppose your mission splits its functionality across multiple CCSDS 
Virtual Channels 

- Each Channel may represent a "service" 

- A Service element could be defined and the list of Containers for 
each APID in the service (VCID) added 

• Options: 


- point to the "super container" per channel 

- Point to each "final" packet container 

- Point to all the containers making up packets on those channels... 


- Etc...? 

- Totally user defined... 
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Chapter 6 - Implementing XTCE 


• A number of ways to implement XTCE 

- #1 - XSLTs, XPath, etc... 

#2 - DOM or SAX custom parser 

#3 - Data-type mapper (XTCE Schema Type to Programming language Classes - "Autogenerators") 
#4 - Combination 

• Focus on #3 

Numerous "autogenerators" 

• Eclipse IDE EMF (Java used) 

• XMLSpy Enterprise (built-in, Java: used) 

• JAXB - now part of Java distro (used) 

• Others: XMLBeans, Castor, ..., many others (& other languages) 

Items to Look For: 

• The order of certain XTCE elements is important 

• Native support or easy bail out to low level processing 

- Ex. Entry order means something 

- Comments or other schema items may not be available directly in mapping 

• Method for determining if attribute value is from a default value or set directly in XML 

- It would be nice but general support seems lacking: 

• DOM > Your Mapped Classes 

• Reason: other XML APIs may sit on DOM 

• Some (minimal) support in JAXB 

• Old XMLSpy mapper sat on top of DOM, not sure of new ones 

• EMF uses its own ECore... 
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Chapter 6 - A Quick Look at JAXB 


• JAXB - Java Architecture for XML Binding 

- Will map your XML Schema (i.e. XTCE) to Java Classes 

• Has additional features including "binding" configuration file 

• Used to implement most of GSFC XTCE prototype software 

- Plusses: 

• Java Generics and Collections well supported 

• Mapping tunable w/config file 

• Now part of official distribution 

- Everyone has it that downloads Java 

• Some support for DOM nodes 

- But not built on DOM (that I can tell!) 

• ...? 

- Misses: 

• Can't seem to parse or build comments 

• Can't convert any unmarshalled object to a DOM node 

- But seem to be able convert any DOM node to a marshalled object 

• ...? 
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Chapter 6 “ JAXB SchemaTypes to Java Mapping 



XML Schema DataType -> Mapping to Java Type or Class 

(some) 


Examples 

xsd:string -> java. lang. String 
xsd:integer -> java. math. Biglnteger 

xsd:dateTime -> javax.xml.dataType.XMLGregorianCaledar 

xsd:double -> double 

Etc... 
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Chapter 6 - JAXB Ex. XTCE SchemaType to Java 



XTCE SpaceSystemType 


XTCE SpaceSystemType Java Class 


<complexType name-'SpaceSystemType" mixed="false"> 
<complexContent mixed="false"> 

<extension base-'xtce:NameDescriptionType"> 

<sequence> 

<element name- 'Header" type-'xtce:HeaderType" 
minOccurs-'0"/> 

<element name- TelemetryMetaData" 

type="xtce:TelemetryMetaDataType" minOccurs-'0"/> 
<element name- 'CommandMetaData" 

type="xtce:CommandMetaDataType" minOccurs="0"/> 
<element name="ServiceSet" minOccurs- '0"> 
<complexType> 

<sequence> 

<element name- 'Service" type- 'xtce:ServiceType" 
maxOccurs="unbounded"/> 

</sequence> 

</complexType> 

</element> 

<element ref="xtce:SpaceSystem" 

minOccurs="0" maxOccurs="unbounded"/> 
</sequence> 

<attribute name-'operationalStatus" 

type-'token" use="optional"/> 

</extension> 

</complexContent> 

</complexType> 



public class SpaceSystemType extends NameDescriptionType 
{ 

protected HeaderType header; 

protected TelemetryMetaDataType telemetryMetaData; 

protected CommandMetaDataType commandMetaData; 

protected SpaceSystemType. ServiceSet serviceSet; 

protected List<SpaceSystemType> spaceSystem; 

protected String operationalStatus; 

public HeaderType getHeader() { return header;} 

public void setHeader(HeaderType value) { this. header = value;} 

public boolean isSetHeader() { return (this.header!= null);} 

public TelemetryMetaDataType getTelemetryMetaData() { 
return telemetryMetaData; 

} 

public void setTelemetryMetaData(TelemetryMetaDataType value) { 
this. telemetryMetaData = value; 

} 

public boolean isSetTelemetryMetaData() { 
return (this.telemetryMetaData!= null); 

} 

public CommandMetaDataType getCommandMetaData() { 
return commandMetaData; 

} 

public void setCommandMetaData(CommandMetaDataType value) { 
this. commandMetaData = value; 

} 

public boolean isSetCommandMetaData() { 
return (this.commandMetaData!= null); 

} 

II ... DELETED FOR SPACE REASONS 

} 


Note: items edited to fit.... 
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Chapter 6 - Simple JAXB XTCE 


Example 


import javax.xml.bind.JAXBContext; 
import javax.xml.bind.JAXBEIement; 
import javax.xml.bind.Marshaller; 
import org.omg. space. xtce.ObjectFactory; 
import org.omg. space. xtce.SpaceSystemType; 


public class SimpleSpaceSystem { 


public static void main(String[] args) { 
JAXBEIement<SpaceSystemT ype> spaceRoot; 
JAXBContext jc; 

Marshaller marshaller; 

ObjectFactory factory; 


try { 

jc = JAXBContext. newlnstance("org.omg. space, xtce"); 
marshaller = jc.createMarshaller(); 
marshaller. 
setProperty( 

"com. sun. xml. internal, bind. namespacePrefixMapper", 
new XTCEPrefixMapper()); 

marshaller. 

setProperty(Marshaller.JAXB_SCHEMA_LOCATION, 

"http://www.omg.org/space/xtce SpaceSystemVI .1 .xsd"); 
marshaller. 

setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, 
new Boolean(true)); 
factory = new ObjectFactory(); 

SpaceSystemType space = factory. createSpaceSystemType(); 
space. setName("HelloWorld"); 
spaceRoot = factory. createSpaceSystem(space); 
marshaller. marshal(spaceRoot, System. out); 

> ca,ch < Exce P ,ion e > < e-PrintStackTracefl; > Note; xjcEPreflxMapper not shown 


<?xml version="1.0" encoding="UTF-8" standalone- 'yes"?> 
<xtce:SpaceSystem xmlns:xtce- 'http://www.omg.org/space/xtce" 
xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" 
name="HelloWorld" 
xsi:schemaLocation= 

"http://www.omg.org/space/xtce SpaceSystemV1.1.xsd"/> 
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Chapter 6 — Harder XTCE Items to Implement 



• General NameReferences and NameReference Instances 

- All "refs" should point to something valid: you must implement this 

- Absolute addresses: /a/b/c and various forms of relative addresses: ../b/c, a/../b, 


- "Path-less" nameRefs which may involve a partial tree search: c 

- Instances: Adds array syntax: /c[l], And aggregate syntax: /a/b/c. subField 

• And relates to some sort of "instance table" 

• Container Inheritance, EntryList, IncludeConditions, etc... 

- Various general aspects of inheritance, EntryList addressing 

• Multiple levels, containerRefs that themselves have inheritance, and so on 

• XTCE Type Inheritance 

• Dynamic Container Match & NextContainer 

- Never been implemented yet that we are aware of... 

(a few more not mentioned) 


etc... 


But wait, I have to implement all of those? Depends. . . 
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Chapter 6 - Native Implementation 


• An implementation that uses XTCE internal to a toolchain 

- Gets packet stream on input, uses XTCE to pull-apart into host-side 
telemetry items 

- Or build cmds for uplink using definitions to supply args, values & format 

• High degree of automation or self-configuration possible 

- Possibly implement every feature of XTCE 

• Thus potentially ingesting ANY XTCE file that is correct to self-configure 
software for any incoming data stream 

- But of course one can always constrain or restrict XTCE support if necessary 

• Implementations? 

- Some aspects of GSFC prototype software falls into this category... 

- But never used to actually decommutate binary packet data (yet) 

- University of Bremen (Germany) implementation used XTCE to configure itself for decommutating 
binary packet file 

• Demo'd ... but source? 
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Chapter 6 - Exchange Implementations 


• 100% XTCE Exchange between teams using same features 

- Agreement ahead of time on which features of XTCE to use 

- Depends somewhat on hardware of team members 

• If controlled or standardized between members: 100% exchange possible 

• As these agreement don't exist, 100% exchange is not possible without 
COMMON AGREEMENTS 

- Ex. Extreme case: I support only telemetry, you support only Commands. Our XTCE files are 
100% incompatible! 

- But even differing formats may offer partial exchange 

• NASA CCSDS & ESA PUS Mission were able to exchange the majority of telemetry metadata 
even though basic packet formats ultimately differ... but it took some work 

• Implementations? 

- GSFC JWST Translator 

- CNES "Best" Suite 

- ESA Cryosat... 

- Several others... mostly on the "Customer" side - (NASAs of the world) 
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Chapter 6 — Ingredients in Successful Exchange 



• Now: 

- Determine exchangees (team members), agree on common "flavor" of XTCE features 

• Future: 

- Industry agreed upon flavors, pick the category you fall into... 

• Develop common XTCE usage "constraints" to format 

- CCSDS is a "format" but stops at the header 

- You have to get down deeper Examples: 

• Polynomials, # of coefficients 

• Alarm levels 

• Floating point sizes and formats 

• Bit/byte ordering... 

• Etc..., etc..., etc... 

• Implement to these constraints & 100% exchange is possible between team 
members, institutions, and so forth 
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Chapter 6 - Automating Exchange? 


• Write XTCE constraints in a computer processable manner 

• Process constraints to configure validation software 

- Use in conjunction with XML Parsing to validate XML in "your" XTCE 

• Process constraints to configure "XTCE builder" software 

- An API that only allows XTCE files to be constructed in "your" flavor 

• Are all constraints describable in a computer processable 

manner? 

??? 

■ ■ ■ 

• Is this an additional area of standardization? 
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Summary 



• XTCE is a large schema with many advanced features for most tlm/cmd 
systems 

- XML, Object Oriented Model for "packaging descriptions" and Commands 

• Native Implemented may implement every facet of XTCE 

- Self-configuration and automation may be high 

• Exchange Implemented may contend with "flavors" 

- Ensure team members are on the same page: common XTCE constraints 

- Some level of automation may be possible, process constraints automatically 

• Generate "constraint validation" and "builder" tool 

• Move towards industry standard flavors 
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Backup Slides 
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Chapter 4 - We want to build this 



The Command: 

• An abstraction for "people”, includes arguments for them to set 

• its Packet, the real bits that make up the command for uplink 


BasicCommand 

MyCommand- args 

BasicCommand 

Packet 

MyCmdPacket 


Although the command itself is an abstraction, its packet is a bit-packed construct 
• That’s inner box in the diagram here 
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Chapter 4 



Metacommand 

Describing a Command in XTCE 
The Concept 



• Arguments - arguments to the command 

- MetaCommand/ArgumentList element 

• CommandContainer - private container for describing the command packaging (but 
can "see" ContainerSet and CommandContainerSet) 

- MetaCommand/CommandContainer element 

• Inheritance - one metacommand may extend ("sub-class" derive) another 

- BaseMeta element 
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Chapter 4 — Basic Command Packet Pattern 




MetaCmd - BasicCommand 


BasicCommand 

Packet 



MetaCmd -MyCmd 
MyCmd Packet 


Note: MyCmd Packet EXPLICITL Y extend BasicCommand Packet in XTCE, NOT SHOWN 
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Chapter 4 - 


Private MetaCommand/CommandContainer 
Also Inherits 



MetaCmd -MyCmd 

MyCmd Packet 


MyCmd Packet EXTENDS BasicCommand Packet - link must be explicit iy set 
-Constraints are optional 

-Constriant are probably Identifying area of Command Packet: values inserted into stream 
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Chapter 4 - Metacommand Inheritance 


The Metacommand Part 


<xtce: Metacommand name=“BasicCommand" abstract= "true "> 

<xtce:CommandContainer name=“BasicCommandPacket”/> 
</xtce:MetaCommand> 

<xtce:MetaCommand name=“ "> 

<xtce:BaseMetaCommand metaCommandRef=“ :Con. "/> 

<xtce:CommandContainer name=“MyCommandPacket”/> 
</xtce:MetaCommand> 


“BasicCommand IS A Metacommand 


“MyCmd IS A BasicCommand” 


Note: arg s/de ta i/s not shown 


The Metacommand /CommandContainer Part 

“BasicCommandPacket IS A MetaCommand/CommandConainer 
“MyCommandPacket IS A BasicCommandPacket 


Note: details left out for illustrative purposes 
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Chapter 4 - 


MetaCommand/CommandContainer 

Highlight 



<xtce:MetaCommand name-' BasicCommand " abstract-'true "> 

<xtce:CommandContainer name= “oasicuummanuracKei. ”/> 
</xtce:MetaCommand> 

<xtce:MetaCommand name-' "> 

<xtce:BaseMetaCommand metaCommandRef-' BasicCommanc "> 
<xtce:CommandContainer name=“MyCommandPacket”/> 
<xtce:BaseContainer containerRef=“BasicCommandPacket”/> 
</xtce:CommandContainer> 

</xtce:MetaCommand> 


“MyCommandPacket IS A BasicCommandPacket 
“BasicCommandPacket ISA MetaCommand/CommandConainer 


Note: Identifying Constraints not shown, similar to Telemetry, but semantics 

are values are inserted into stream 
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Chapter 4 - Command & Packet 


What we got 


BasicCommand 




Although the command itself is an abstraction, its packet is a bit-packed construct 
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